home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1995 October
/
EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso
/
Aminet
/
comm
/
xeno
/
bbbbscd.lha
/
BBBBScd
/
readme.install
< prev
next >
Wrap
Text File
|
1995-03-17
|
13KB
|
346 lines
BBBBS/Xeno CD Door V1.00 (First General Release / Hatched to XENOL 18/3/95)
---------------------------------------------------------------------------
This is V1.00 of BBBBScd, a CD door for Xenolink 1.90+
This distribution is also an update to V0.90 Beta.
Changes & Enhancements:
-----------------------
* Made all the scripts read XCONFIG:BBBBScd.config for sysop configurability
* Added LZX/LHA choice for user. (See warning re: LZX and CDROM filesystems)
Requirements:
-------------
* This utility was written & tested on Kickstart 3.0, on an A4000/40.
The rexx support libraries are compatible with the above configuration.
As for older/newer kickstarts... it's up to you to check first.
* Xenolink Professional BBS V1.90+
* LHA and LZX somewhere in your Amiga's command PATH
Installation:
-------------
1. Basically, you should already have unpacked this archive to your doors:
assign, and should be reading this text file from doors:bbbbscd/
*NB* The user archives and temporary Email will be written to sub-dirs
of Doors:BBBBScd/, but this is configurable by you after installation
2. COPY DOORS:BBBBScd/SYSTEM/ SYS: ALL CLONE
- This will install the rexx scripts, rexx support libs, and the PD
utilities "Newlist" and "RunBack" to your system boot partition.
*WARNING* - if you still run kickstart 1.x...
- check the versions of the 2 included libraries if you already have them
in your system partition. Those supplied SHOULD work on OS2.x or OS3.x,
and NOBODY is using 1.3 nowadays anyway, are they?
3. COPY DOORS:BBBBScd/XENOLINK/ XENOLINK: ALL CLONE
- installs the menus and menutext for you.
- installs the default xconfig:BBBBScd.config for you.
- also installs 'Junkmail' V1.90 (c) Alan Bond in Xenolink:utilties
- you may miss this out if you already have it (or a newer version)
4. Compile CDbbbbs.src and add a CALLMENU "CDbbbbs.menu" statement somewhere
in your own menus.
To compile the provided menu, type MENU CDbbbbs.src
XCONFIG:BBBBScd.config
----------------------
You should now be ready to rock 'n' roll... using the default settings, but
here's the current config options available in xconfig:BBBBScd.config...
<-- snip -->
Doors:bbbbsCD/
CD0: CD1: CD2: CD50: CD51: CD52: CD53: CD54: CD55: CD56:
224
0
Teri Odin CD
5000000
4000000
Y
****************************************************************************
* Xenolink BBBBScd door, Configuration file *
****************************************************************************
Line 1: Path to BBBBScd/ dir where file archives & temp email will be stored
Line 1: List of ADOS devices or Assigns which will be used by BBBBScd door
Line 3: Minimum user level to allow Writing of New CD Caches on large dirs
Line 4: Xenolink Message base # to be used to email user with file attach
*MUST* be a 'local' msgbase (not netmail) and must allow PRIVATE msg
Line 5: The FROM: 'name' of the CD Door, as appearing in msg header (Your BBS?)
Line 6: The largest recursive SELECT ALL bytes total allowed in one select
Line 7: The total output archive(s) size allowed. Archiving will stop after
this amount of data has been file attached to the user.
Line 8: LZX option (Y)es or (N)o - LZX1.00 won't archive with some CDROM
Filesystems
****************************************************************************
<-- snip -->
Other Considerations:
---------------------
1. It is assumed that LHA and LZX are somewhere in your workbench command
path, and neither are included with this archive
2. As menioned in the lso, script bbsArcExt.rexx has a parameter to set the
msgbase number consig file, the selected msgbase must currently be a LOCAL
(non echomail) msgbase valid for your BBS, and it must also allow PRIVATE
mail.
- If you change the msgbase from the default of #0, you will need to edit
and recompile CDbbbbs.src menu to use your selected msgbase instead.
5. ***WARNING***
- After installing & using this door, my NewUser.Rexx script !!!STOPPED!!!
!WORKING! ;(
- I think it is something to do with the rexxarp.library, but haven't
tracked it down yet.
- You can 'fix' your BBS newuser.rexx script by putting the following
statements into your newuser.rexx script, immediately after the
"PARSE ARG name." line near the beginning...
<-- snip -->
/* Open the support library if it is not already open. */
if ~show('L',"rexxsupport.library") THEN
DO
addlib('rexxsupport.library',0,-30,0)
END
if ~show('L',"rexxmathlib.library") THEN
DO
addlib('rexxmathlib.library',0,-30,0)
END
PRINT ' '
if ~show('L',"rexxarplib.library") THEN
DO
addlib('rexxarplib.library',0,-30,0)
END
<-- snip -->
- Inserting the above statements should sort out any problems you
might have with other rexx scipts, but I'd appreciate feedback on
this problem for a more elegant & permanent solution, please! ;)
***WARNING*** Possible LZX archiving problem with some CDFILESYSTEMS
--------------------------------------------------------------------
On Teri Odin, I use the AsimCDFS CDROM filesystem, and LZX archives
end up with CRC checksum errors where files are addes from CD drives
using the above mentioned CDFS.
I have tested it out on 2 SCSI controllers, and both exhibited the
same problem.
Tests of LZX archiving from one hard disk to another were 100% Successfull!
I will look further into this problem to try and find a solution, but
a special option has been added to the XCONFIG:BBBBScd.config so that you
can prevent the user from being offered the LZX packing option if your
system suffers the same probs. ;)
To find out if your CD Filesystem is affected, try archiving a file from
one of your cd drives and then runthe LZX t (test) option on the archgive.
<-- snip --> (example used: Aminet 5 CDROM)
16.Ram Disk:> list aminet5:index
Directory "aminet5:" on Friday 17-Mar-95
index 16898 ----rwed 17-Feb-95 16:51:57
1 file - 10 blocks used
16.Ram Disk:>
lzx a ram:test aminet5:index
LZX 1.00 (Evaluation) Archive/Extract utility - 68040/68060 Version
Copyright © 1995 Data Compression Technologies. All rights reserved.
Commercial use of this unregistered program is prohibited
Creating new archive 'ram:test.LZX':
Adding ( 15) aminet5:index %00
** 1 file(s) added
16.Ram Disk:> lzx t ram:test
LZX 1.00 (Evaluation) Archive/Extract utility - 68040/68060 Version
Copyright © 1995 Data Compression Technologies. All rights reserved.
Commercial use of this unregistered program is prohibited
Testing archive 'ram:test.LZX':
( 0 / 15) index ( 15) ** BAD CRC (wanted F18B242F got A2A244D
B): index
** 1 file(s) tested, 1 file(s) BAD ]
<-- snip -->
If you see the BAD CRC message above, then you need to disable LZX archiving
until a later release of BBBBScd, when the problem will hopefully be solved.
Extra SHELL door:
-----------------
As an extra, I have provided a SHELL/CLI version of the bbsExtDl rexx script,
which you can use 'offline' to Cache new CD's, or even as a Multiple
'File Attach' utility to send file(s) to your users.
Option 1: (File attach some CDROM files to a user)
---------
Open a shell and type rx s:bbsExtDl.SHELL User_Name
(User_name is the user you wish to receive the files)
Option 2: (Cache a new CDROM).
---------
As above, but you don't need the username.
Currently, you have to select each dir one by one, (what a slog!) but I'm
working on an automated version which will cache a whole CDROM... Soon! ;)
Any directory containing more than 25 files or sub-dirs will offer you the
option to Pre-Cache the directory, so that when the users browse this CD
online, they get almost instantaneous filelists! This overcomes the slow
nature of an Arexx door such as this one.
Option 3: (Send *ANY* file(s) to a user from shell)
--------
Open a SHELL and type rx s:ArcExt.rexx User_Name node archiver file file/*
The above command uses parameters as follows...
User_Name = The user who will receive the file(s). Replace spaces with "_"
Node = Always '0' from the SHELL
archiver = X for LZX or H for LHA
file,file/* = The filename(s), including full path. As many as you like, just
seperate each one with a space. (You can't archive single files
which have a space within the filename!)
You may also do a recursive file/sub-dir archive by entering
a full path, ending with "/*" e.g. AMINET5:AMINET/COMM/*
Finally, here's my recent echomail announcement about the door, from
Xeno_Utils echo, in case you missed it... ;)
*** Area: NET_2_259_75_1 Date: 11 Mar 95 23:32:45
*** From: Derek Scott (2:259/75.1)
*** To : Derek Scott (2:259/75.0)
*** Subj: BBBBS/Xeno CD Door
* This message forwarded from area 'XENOLINK_UTIL' (XENOLINK_UTIL)
* Original message dated 11 Mar 95, from Derek Scott
BBBBS CD Door converted to Xenolink
-----------------------------------
Is there room in the Xenolink sysop community for (YET) another CD door?
I have just converted Richard Lee Stockton's Arexx CD door to run under
Xenolink, and would be happy to 'hatch' it *if* its features have something
not already available to Xenolink sysops.
Features List
-------------
* Presents user with 'SHELL' type dispay, and allows uses to move freely
within the tree path of any CD or valid ADOS device/assign. All devices
are treated as READ ONLY and are sysop configurable, thus users only have
access to areas you define (i.e. parts of your h-d)
* CD_Exclude file holds list of files which door should not display to user.
- corrupt files, virus infected CD files, copyright files, X-Rated files?
* User may READ text files, view archives contents etc.
* Can select individual files from multiple devices in one session.
* Can SELECT ALL files (plus any & all sub dirs) from current directory.
* Pre-caches large directories to h-d to greatly increase display speed.
- Pre cache writing is only available to users with sysop defined level
or higher.
* All selected files are archived together - as a background task - and
sent as a file attach to the user in sysop definable msgbase.
- If user logs out it will be ready & waiting when they next log in.
- Self deleting upon successful download
- Currently uses LHA archiving. (LZX also available, but with restrictions)
* Sysop definable MAX_SIZE on both recursive directory/file selection and
on output archive size.
* Online HELP page
* Archiver script can be run seperately from shell/cli to send file(s) to
user as attached file/msg, including recursive directory archiving.
* Will happily use ADOS 'Assigns' as well as devices
- Useful for PC CD's with illegal ADOS volume names like D::
- Can be persuaded to 'rename' above CD so user only sees assigned name.
Future Features
---------------
* User selectable archiving filetype.
- LZX available from V1.00, but see docs for details of CDFS / LZX probs
- Support to use all your current xconfig:archivers.config entries
* Auto detection and support of 'Point' users off your BBS.
- Use Xfidonet:pointlist.123 and systems.config to detect point user
and preferred archiving method
- send archive & msg direct to point in xout:
* Anything else within reason <G>
Background
----------
I ran a BBBBS board for almost a year, and the CD door was popular, as it
is easy to use, 'learns' new CD's by pre-caching large directories to h-d,
and *best* of all, it bundles collections of files and archives them into
a few d/l archive packets.
I spend some time rewriting the recursive SELECT ALL function for 2 reasons:
1. Limit max size to a sysop-definable amount of bytes (on input to
archiver)
2. Cope with bundling filenames even if they contain spaces (only on
recursive SELECT ALL - still won't use single files with spaces)
I also added multi-line support by adding node numbers to all filenames and
data-structures used by the 2 scripts.
Requirements
------------
* Requires ADOS 2.x or above, and (obviously) AREXX.
* Requires rexxarp.library and rexxmath.library (Supplied)
* Requires QUICKSORT, NEWLIST and RUNBACK commands (supplied)
* Requires LHA, LZX (and any future supported archivers) in your command path
* Uses NewList (C= 'List' replacement) to recursively size SELECT ALL files
* Uses Junkmail, (c) Alan Bond to handle the msg upload & file attach(s).
Feel free to pop online to Teri Odin (if you're in the UK) on node 1
01450-373323 and try it out first to see what you think. ;)
Regards,
_ _
Derek Scott, _ // AMIGA - To boldly go _ //
Sysop, Teri Odin BBS \X/ where no PC has gone before \X/